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SPECIFICATION 

Electronic Version 1.2.8 
Stylesheet Version 1 .0 

?f Tooltip Hyperlinks " 

Background of Invention 

[0001] This invention pertains to computers and other data processing systems and, 

more particularly, to an information processing system including a software program 
having pop-up "tooltips" in which the tooltip includes a hyperlink. 

[0002] In a software application having a graphical user interface, "objects" are typically 
displayed on screen to permit the user to selectively activate different functions 
associated with each object. A mouse or other pointing device is used to control the 
movement of a cursor, and the user activates the function associated with the object 
by moving the cursor over the object and depressing a switch or "button" on the 
pointing device, a process commonly known as "clicking" on the object. 

[0003] An object may consist of text, graphics, or a combination of text and graphics, 

although the size of an object is usually kept to a minimum to conserve space on the 
display screen. Because of its limited size, the function associated with each object is 
often unclear, and "tooltips" are frequently used to provide additional information 
about an object. A tooltips is a small window containing additional text that pops-up 
when the user positions the cursor over an object, and disappears when the cursor is 
moved off the object. 

[0004] 

For example, in a popular word processing program, there is an object consisting 
of a small graphical image of an open book in which a letter "S" is visible on one of the 
open pages. While the function associated with this object may not be readily 
apparent simply by viewing the graphical image, placing the cursor over the object 
causes a small window or "tooltip" to appear adjacent the object with the following 
text being displayed within the tooltip window: "Spell Check - Check and correct 
spelling - Ctrl + Fl". Thus, by clicking on this small graphical image of an open book, 
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the spell check function of the word processing program is invoked. 

[0005] While the primary function of a prior art tooltip is to provide additional 

information about the associated object, the tooltip itself is often limited in size, 
which limits the total amount of information that can resides within the tooltip 
window. Therefore, the invention described below provides a hyperlink within the 
tooltip window, so that the user can obtain additional information or additional 
function by clicking on the hyperlink in the tooltip window. 

[0006] One of the problems that the current invention overcomes is that a prior art 

hyperlink is activated by clicking on the hyperlink, which requires that the cursor be 
placed over the hyperlink in the tooltip. However, in a prior art tooltip, as soon as the 
cursor is moved off the object, the tooltip disappears. Thus, it is not possible to place 
the cursor over any portion of a prior art tooltip, because the tooltip disappears as 
soon as the user attempts to move the cursor from the object to the tooltip. 

Summary of Invention 

[0007] Briefly, in one embodiment, the invention is a computer program product 

embodied in a machine readable media (such as, but not limited to, a magnetic disk, 
an optical disk, or a semiconductor memory) that is executable by a processor. The 
computer program product is for use with a computer system having a display screen, 
a switch, and a pointing device (such as, but not limited to, a mouse, trackball, 
pointing stick, or various keyboard controls for cursor movement) for moving a cursor 
image on the display screen. The computer program product includes program 
instructions for performing the following steps. Displaying an object on the display 
screen. Displaying a tooltip on the display screen in response to the positioning of the 
cursor image over the object. Continuing to display the tooltip in response to the 
movement of the cursor from the object to the tooltip. 

[0008] 

In another embodiment, the invention is a data processing system for use with a 
display screen, a switch, and a pointing device for moving a cursor image on the 
display screen. The data processing system includes means for displaying an object 
on the display screen, and means for displaying a tooltip on the display screen in 
response to the positioning of the cursor image over the object. Also included are 
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means for continuing to display the tooltip in response to the movement of the cursor 
from the object to the tooltip. 

Brief Description of Drawings 

[0009] Fig. 1(a) is an image of a display screen in which an object is displayed and the 
cursor is positioned off the object. 

[0010] Fig. 1(b) is an image of a display screen in which an object is displayed and the 
cursor is positioned over the object, causing a tooltip to appear. The doted image of 
the cursor indicates its previous position. 

[001 1] Fig. 1 (c) is an image of a display screen similar to Fig 1 (b), except that the cursor 
has been moved from the object to the tooltip to illustrate that tooltip does not 
disappear when the cursor is moved off the object and onto the tooltip. A hyperlink is 
also illustrated within the tooltip. 

[001 2] Fig. 1 (d), is an image of a display screen similar to Fig 1 (c), except that the 
hyperlink has been activated to display "linked data" in a new window. 

[001 3] Fig. 1 (e), is an image of a display screen similar to Fig 1(a), except that cursor has 
been moved off the object, to illustrate that the tooltip disappears when the cursor is 
no longer positioned over either the object of the tooltip. 

[0014] Fig. 2 is a block diagram of a computer system capable of executing computer 
programming code according to the invention described below. 

Detailed Description 

[0015] 

In Fig. 1 (a), an object J 02 is displayed on a well known display screen 1 01 . Object 
102 has an associated function, which can be selectively activated by the user. 
Common functions associated with objects include print, save, cut, paste, etc. A well 
known mouse or other pointing device is used to control the movement of a cursor 
image (illustrated at position 103) on screen 101, and the user activates the function 
associated with the object by moving the cursor over the object and depressing a 
switch or "button" on the pointing device, a process commonly known as "clicking on" 
the object. Fig. 1(a) has been provided primarily to illustrate that no associated tooltip 
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is displayed on screen 101 when the cursor image is off object 1 02, as illustrated at 
position 103. 

[0016] In Fig. 1(b), the cursor image has been moved from previous position 103 

(wherein the cursor is shown in phantom form) to position 1 04 over object 1 02. Upon 
moving the cursor over object 1 02, tooltip 1 05 appears. Tooltip 1 05 includes tooltip 
text 106 (typically in the form of helpful information about the object) and a well 
known hyperlink 1 07. Note that a portion 1 08 of tooltip 1 05 overlaps object 1 02. 

[0017] In Fig. 1(c), the cursor has been moved from previous position 104, to position 
109 over tooltip 105. In moving the cursor, it is preferred that it be moved from 
position 104, across the overlapping portion 108 of tooltip 105, and onto the non- 
overlapping portion of the tooltip, such as position 109. This figure demonstrates that 
the tooltip is displayed despite the fact that the cursor has been moved off object 
102. 

[001 8] In Fig. 1 (d), the cursor image has been moved from position 1 09 to position 1 1 0, 
which is over hyperlink 107. Upon the activation of the switch associated with the 
pointing device, a new window appears on screen 101 containing "linked data", which 
is text, graphics or other data that is associated with hyperlink 1 07. In a typical 
application, tooltips are used to provide "help" information about the object, and the 
linked data can be used to expand upon the limited amount of help information that 
can be displayed in a tooltip, which are usually very small windows with limited ability 
to provide significant amounts of information. 

[001 9] In Fig. 1 (e), the cursor has been moved from either position 1 04 or position 1 09 
to position 1 12, to demonstrate that the tooltip is removed from display screen 101 
when the cursor is moved off both the object and the tooltip. 

[0020] 

Fig. 2 is a block diagram of a well known computer system capable of executing 
the exemplary computer code described below and implementing the function of the 
invention described above. A central processing unit or "CPU" 201 is coupled to a 
graphics/memory controller 202. Semiconductor memory 203, such as dynamic 
random access memory or "DRAM" memory is coupled to graphics/memory controller 
202. In addition, a display adapter 204, such as an accelerated graphics port or "AGP" 
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graphics adapter, is also coupled to graphics/memory controller 202. Display screen 
1 01 is coupled to display adapter 204. 

[0021] An Input/Output or "I/O" controller hub 205 is also coupled to graphics/memory 
controller 202, and a non-volatile memory containing BIOS code is coupled to the I/O 
controller. A hard disk drive 207 is also coupled to the I/O controller. Hard disk drive 
207 is suitable for storing the programming code described below. A keyboard and 
mouse controller 208 is coupled to the I/O controller, and a mouse 210 and keyboard 

209 are coupled to controller 208. While mouse 2 1 0 is illustrated in Fig. 2, other well 
known pointing devices may be used, such as a trackball, pointing stick, or even 
certain keys of the keyboard may be used to control a cursor image on screen. Mouse 

210 includes switches 21 1 and 212, commonly called buttons, to activate functions 
associated with the current position of the cursor image on screen. Collectively, the 
computer system of Fig. 2 provides a means for executing the program functions 
described in the specification. 

[0022] Two listings of exemplary computer code follow. This code can be executed in a 
well known personal computer, or in other well known computers or data processing 
equipment. The first listing entitled HTML ToolTip.java extends the tooltip 
functionality provided the Java Foundation Classes 1 (JFC) JToolTip. In this class, we 
override the default behavior of JToolTip, which is to display a short, plain-text, 
single-line tooltip. Instead, we display a tooltip that renders HTML, providing for 
hyperlinks, tables, graphics, and line-wrapped, styled text within the tooltip. 

[0023] The second listing, InfoTable.java, is a class that extends the default table 

functionality provided by JFC f s JTable class. JTable, like other JFC GUI components, 
provides a default tooltip implementation based on JToolTip. In order to substitute our 
tooltips for the default, we added the method createToolTip to InfoTable; this method 
returns an instance of our HTMLToolTip class, rather than the default JToolTip. We 
also added the method getTooiTipLocation that carefully controls the location where 
the tooltip appears; this allows the user to move the mouse cursor into the tooltip and 
to interact with its contents. 

[0024] 
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HTML ToolTip. JAVA 
Code Listing 



public class HTMLToolTIp extends JToolTip 
{ 

private final int MAX_WIDTH = 200; 
private final int MAX_LINES = 6; 

MyHTMLEditorKit htmlKit; 
JEditorPane editorPane; 
JScrollPane scrollPane; 
HelpProviderlntf helpProvider; 

/** Constructor for an HTML tool tip. 

* @param component the JComponent that will display this tooltip 

* @param helpProviderlN the help provider that will display more info 

if this tooltip contains any navigable HTML links 

7 

public HTMLToolTip(JComponent component, HelpProviderlntf helpProviderlN) 
superO; 

helpProvider = helpProviderlN; 
setComponent(component); 
setLayout(new BorderLayoutO); 
setBorder(null); 

htmlKit = new MyHTMLEditorKit(); 
editorPane = new JEditorPane (); 
editorPane.addHypertinkListener(new Hyperactrve{)); 
editorPane.setEditable (false); 
editorPane.setEditorKit(htmlKit); 

Border border = (Border) UJManager.get("HTMLToolTip.border"); 
if (border = null) 

border =r new CompoundBorder(new LineBorderfUIManager.getColorOextHighHght"), 1), 
new LineBorder(editorPane.getBackground(), 3)); 

setBorder(border); 

//scrollPane = new JScrollPane(editorPane); 
add(editorPane, Bo rderLayout CENTER); 

} 

r* Set the text for this tooltip. 

* @param tipText the string to display 
7 

public void setTipText(String tipText) 
{ 

if (tipText = null) 
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{ 

setPreferredSize(new Dimension(0, 0)); 
return; 

} 

BufferedReader in = new BufferedReader(new String Reader(tipText)); 
try 
{ 

editorPane.setDocument(htmlKit.createDefaultDocument()); 

((HTMLDocument) editorPane.getDocument()).setBase(HelpSystem.getBaseURL()); 
html Kit. read(in, editorPane.getDocument(), 0); 

catch (Exception e) 
{ 

//failed to initialize tooltip, so show nothing 
setPreferredSize(new Dimension (0, 0)); 
retum; 

} 

// set the size of this tool tip 

FontMetrics metrics = Toolkit.getDefaultToolkit().getFontMetrics(new Font("SansSerif'\ 
Font. PLAIN, 11)); 

int totalWidth = metrics.stringWidth(visibleText(tipText)); 
double rawWidth = Math. m in (totalWidth, MAX_WIDTH); 
int width = (int) rawWidth + 50; // pad for scrollbars, border, etc. 

//int lines = (int) Math. min(Math.ceil(total Width / rawWidth) + 0.5, MAXJJNES); 
int rawLines = (int) Math.ceil(tota!Width / rawWidth); 
int lines = rawLines + getExtraLineCount(); 
int rawHeight = (int) (metrics.getHeight() * 1.25 * lines); // fudge factor to handle space added by 
line wrapping 

int height = rawHeight + 18; // pad for scrollbars, border, etc. 

setPreferredSize(new Dimension (width, height)); 

// in case we must scroll, start at the top 
editorPane.setCaretPosition(1 ); 

} 

r* JDK 1 .3 on Windows works fine, but the 1 .1 .8 JEditorPane adds an extra blank line to the top of 
the 

* document it is rendering, causing the tooltip to be cut off. Other OS's seem to need this extra 
line 

* all the time. 

* ©return 0 for JDK 1 .3 on Windows, else 1 
V 

private int getExtraLineCount() 
{ 

if (UIManager.getLookAndFeelO.getNameO.equalsCWindows") && 
System.getProperty('java.version").startsWith( ,, 1.3")) 
return 0; 
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else 
return 1; 

} 

private static final double FACTOR = 0.85; 

/** This method takes an HTML string and returns only the visible portion 

* of it, that is, the text between the HTML tags. 

* @param htmlText the HTML input string 

* @ return the text between the HTML tags 
7 

v private String vis»bleText(String htmlText) 
{ 

String token; 
boolean inTag = false; 

StringTokenizer st = new StringTokenizer(htmlText, "<", true); 
StringBuffer vrsibleText = new StringBufferQ; 

while (sthasMoreTokensO) 
{ 

token = (inTag) ? st.nextToken(">") : st.nextToken("<"); 
if (token. equals("<")) 

inTag = tnje; 
else if (token.equals(">")) 

inTag = false; 
else if (linTag) 

visibleText.append(token); 

} 

return visibleText.toString(); 

} 

/" The hyperlink listener used by the HTMLToolTip class. 7 
class Hyperactive implements HyperhnkListener 

public void hyperlinkUpdate(HyperlinkEvent e) 

if (e.getEventType() — Hype rljnk Event. Eve ntType. ACTIVATED) 

JEditorPane pane = (JEditorPane) e.getSource(); 

try 

{ 

jf ((e.getURL() != null) && !e.getURL().getProtocol0.toLowerCase().startsWith("http")) 
helpProvider.activateHelp(e.getURL()); 

} 

if ((e.getDescriptionQ l= null) && 
(e.getDescription (). length () > 0) && 
!e.getDescription().toLowerCase().startsWith("http:")) 

helpProvider.activateHelp(HelpSystem.getURLFromFilename(e.getDescriptionO)); 



[0027] 



APP-ID- 10064292 



PAGE 8 of 20 



.^i. ii„,s! irji ^ii-ur::, ~ -* &;r. ». ;o »™. o-slj" icr 



} 

) 

catch (Throwable t) 
{ 

JCRMUtil.ErrorLog(JCRMUtil.throwableStackTraceToString(t)); 

} 

} 

} 

class MyHTMLEditorKit extends HTMLEditorKit 
{ 

/" 

* Create an uninitialized text storage model 

* that is appropriate for this type of editor. 
* 

* ©return the model 
7 

public Document createDefaultDocument() 

HTMLDocument document = (HTMLDocument) super.createDefaultDocument(); 

document.setAsynchronousLoadPriority(-l); 

return document; 

) 

} 

) 
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Info Table JAVA Code 



class InfoTabfe extends JTable 
{ 

/** Our custom renderer that can render icons to highlight problems. */ 
InfoTableCellRenderer rendered 

/** Help provider that displays help invoked from tooltips. 7 
HelpProviderlntf helpProvider; 

/** Returns a new instance of InfoTable. 
* @param model the table model 
7 

lnfoTable(lnfoTableModel model, HelpProviderlntf helpProviderIN) 
super(model); 

helpProvider = helpProviderIN; 

setRowSelectionAllowed(false); 
setColumnSelectionAllowed(false); 
setCellSelectionEnabled(false) ; 

setAutoResizeMode(JTable.AUTO_RESIZE_LAST_COLUMN); 

sizeColumnsToFit(-l); 

setShowGrid(false); 

setlntercellSpacing(new Dimension(0, 0)); 
setGridColor(UIManager.getColor('Button.background'')); 

getColumnModel().addColumnModelListener(this); 
renderer = new I nfoTableCellRendererO; 

getAccessibleContext().setAccessibleName(JCRMUtil.getNLSStringCdetailsTable n )); 



/** We listen for TableColumnModelEvents so that we may add our custom 

* TableCellRenderer to each column that gets created. 

* <@ param evt the event describing the creation of a table column 
7 

public void columnAdded(TableColumnModelEvent evt) 
super.columnAdded(evt); 

TableColumn Model columnModel = (TableColumnModel) evt.getSource(); 
colum n Model .getColumn(evt.getTolndex()).setCellRenderer(renderer); 

/** Work around a bug in JComponent. Launch is an applet in a frame, but 

* this method in JComponent stopped at the applet; we need the frame. 

* @ return the top level container for this component 
7 

public Container getTopLeveJAncestor() 
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for (Container p = this; p 1= null; p = p.getParentO) 
if (p instanceof Window || ((p instanceof java.applet. Applet) && (p.getParentO == null))) 
return p; 
return null; 

} 

/** Returns our custom HTMLToolTip object. 

* ©return an HTML tool tip 

7 

public JToolTip createToolTipO 
{ 

HTMLToolTip tip = new HTMLToolTip(this, helpProvider); 
return tip; 

) 

r* Returns the location for our custom HTMLToolTip object. 

* ©param event the MouseEvent that determines where the cursor is 

* ©return the location for the tool tip 

7 

public Point getToolTipLocation (MouseEvent event) 
{ 

// Locate the renderer under the event location 

Point p = event.getPoint(); 

int hitColumn Index = columnAtPoint(p); 

int hitRowlndex = rowAtPoint(p); 

Rectangle cellRect = getCel!Rect(hitRowlndex, hitColumnlndex, false); 
return new Point(10, cellRect.y + cellRect.height - 3); 

} 
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